home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / System / DOpus / DopJoin5 / DopJoin5.doc < prev    next >
Encoding:
Text File  |  2001-04-02  |  3.6 KB  |  113 lines
  1.  
  2.                  Join files with DirectoryOpus 5.xx
  3.                  ---------------------------------
  4.  
  5.                             DopJoin5
  6.                           DopJoinAsync5
  7.                           =============
  8.  
  9.                      Version 1.00 - 01.04.01
  10.  
  11.                          © H. van der Ree
  12.  
  13.                          hivdree@uwnet.nl
  14.  
  15.  
  16. DopJoin5 and DopJoinAsync5 are small programs with which you can
  17. join files with DirectoryOpus 5.xx.
  18.  
  19. DopJoin5 and DopJoinAsync5 are copyright 2001 by H. van der Ree
  20. and EMailware. That means if you like them and use them, you must
  21. send me an email. I would really like to hear about how you've used
  22. the programs.
  23.  
  24. DopJoin5 and DopJoinAsync5 are free to use and copy as you see fit.
  25. The Author retains all rights to the programs. The Author is not
  26. responsible for any damage the programs may cause. If you distribute
  27. the archive, you MUST distribute the entire package.
  28.  
  29. These programs may be included in any archive collection. 
  30.  
  31. =====================================================================
  32.  
  33. DESCRIPTION:
  34.  
  35. Not much to say really: these little programs join all the selected
  36. files in the source lister to a new file in the destination lister.
  37. DopJoin5 and DopJoinAsync5 only works on files, selected dirs will
  38. be ignored.
  39.  
  40. DopJoin5 and DopJoinAsync5 will ask for a filename and will add the
  41. path of the destination. If a filename is given WITH a full path the
  42. path is stripped!
  43.  
  44. There are two options. The first is APPEND. When used the selected
  45. files will be added to the destination file. If the file doesn't
  46. exist it will be created. Without this option an existing file
  47. in the destination with the same name will be overwriten!
  48.  
  49. The second one is KEEP. This will keep the temporary file in T: in
  50. which the files are listed that were joined.
  51. The first line of this file is the name of the destination file.
  52.  
  53. Errors, if any, will be saved to file RAM:DopJoinErrors. They are
  54. listed with date and time, IoErr() and what caused the error.
  55.  
  56. DopJoinAsync5 does the same as DopJoin5 but uses asyncio.library.
  57. It is ~20% faster.
  58.  
  59. =====================================================================
  60.  
  61. REQUIREMENTS:
  62.  
  63. DirectoryOpus 5.xx. Only tested with 5.11 but newer versions should
  64. work.
  65.  
  66. ARexx must be running. DopJoin5 and DopJoinAsync5 uses ARexx to
  67. communicate with DirectoryOpus.
  68.  
  69. If you want to use DopJoinAsync5 asyncio.library must be in Libs:
  70.  
  71. DopJoin5 and DopJoinAsync5 have been tested with FFS 45.9 and OS3.1.
  72.  
  73. =====================================================================
  74.  
  75. INSTALLATION:
  76.  
  77. Install DopJoin5 or DopJoinAsync5 as an AmigaDOS program with one
  78. argument: {Qp}. The only flag that MUST be set is
  79. 'Run asynchronously'!
  80. Optionally you can add the options KEEP and/or APPEND.
  81.  
  82. An other way is to 'run <>NIL: DopJoin5 {Qp} [KEEP] [APPEND]'.
  83.  
  84. If DopJoin5 or DopJoinAsync5 aren't running asynchronous Dopus will
  85. be locked!
  86.  
  87. =====================================================================
  88.  
  89. HISTORY:
  90.  
  91.   DopJoin5:
  92.  
  93.   1.00 - 31.03.01  First public version.
  94.  
  95.   DopJoinAsync5:
  96.  
  97.   1.00 - 01.04.01  First public version.
  98.                    It is tested with asyncio.library versions 39.2
  99.                    and 40.4. It doesn't use the PPC functions of
  100.                    40.4.
  101.  
  102. =====================================================================
  103.  
  104. DISCLAIMER:
  105.  
  106.   THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  107.   EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR
  108.   ANY DAMAGES, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL,
  109.   RESULTING FROM THE USE OF THE PROGRAM. THE ENTIRE RISK AS TO THE
  110.   USE OF THIS PROGRAM IS ASSUMED BY THE USER.
  111.  
  112. =====================================================================
  113.